home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / viewers / glist113 / glist113.doc < prev    next >
Encoding:
Text File  |  1990-04-03  |  6.5 KB  |  181 lines
  1.  
  2. GIFLIST
  3. Documentation for V1.13 02 APR 1990
  4.  
  5. /*
  6.  *
  7.  * The  program  and its accompanying documentation are  Copyright  1989
  8.  * Dragon Technologies, Ltd.  It may be freely copied and distributed as
  9.  * long as no charge is made at any point of its distribution.
  10.  *
  11.  * All rights reserved with the following exceptions:
  12.  *
  13.  * This software is supplied free of charge.  This software, or any part
  14.  * of it, may  not  be  redistributed or otherwise made available to, or
  15.  * used  by, any  other  person  without the inclusion of this copyright
  16.  * notice.  This software may not be used to make a profit in any way.
  17.  *
  18.  * This software  is provided with absolutely no warranty, to the extent
  19.  * permitted by  applicable  state law.  In no event, unless required by
  20.  * applicable law,  will the author of this this software be liable  for
  21.  * any damages caused by this software.
  22.  *
  23.  * This software is not to be placed on CompuServe Information Service.
  24.  *
  25.  */
  26.  
  27. GIF and Graphics Interchange Format are trademarks of CompuServe
  28. Information Services, Inc., an H&R Block company.
  29.  
  30. If you feel GIFLIST has been of any use to you, a donation is
  31. appreciated, though not necessary.  There will be future updates to
  32. GIFLIST, as well as other GIF/graphics utilities.  A donation of $10
  33. is suggested, and will help keep quality software such as this
  34. available.  The source code for GIFLIST (written in Microsoft C 5.0
  35. and Turbo C 2.0) is available with a donation of $20 or more.  A disk
  36. with the source code and the latest version of GIFLIST will be returned
  37. to you, plus it will have some of the latest and greatest DragonScans to
  38. boot.
  39.  
  40. GIFLIST lists all files matching the file mask in the specified
  41. directory, and examines each of these files.  By default, GIFLIST
  42. examines files in the current directory with the extension of "GIF."
  43. If you run GIFLIST in its defaul mode, after printing a short header
  44. containing program information, the name of each file is printed,
  45. followed by the file size in bytes, the raster image size (HxV), the
  46. number of colors used in the picture, and color resolution (in bits).
  47.  
  48. Options include a quiet mode, so that the headers are not printed;
  49. not printing the color resolution information, or displaying it in bit
  50. planes rather than bits;  showing the version information;  and
  51. displaying a help screen listing options.
  52.  
  53. All information is printed on standard output, so it will be shown on
  54. your screen as a default.  Output may be redirected to a file or the
  55. printer, or may be run through the SORT filter.
  56.  
  57. Note two versions are available.  Version 1.13tc has been compiled
  58. under Borland Turbo C 2.0.  Version 1.13msc has been compiled under
  59. Microsoft C version 5.1.  Both programs function identically, with the
  60. exception that the Turbo C version displays the time the file was listed
  61. also.  Performance is similar, but the Microsoft executable is smaller
  62. in size.  There are still minor bugs in the Turbo C version (as of this
  63. release).  These will be eventually cleared up.
  64.  
  65.  
  66. Sample output:
  67. ==============
  68.  
  69. GIFLIST 1.13msc (02 APR 1990)  Listed on: 02 APR 1990
  70. Copyright 1990 Dragon Technologies (All rights reserved)
  71.  
  72. FILENAME       BYTES     DATE     RESOLUTION/COLORS/COLOR RES
  73.  
  74. AWAITING.GIF  198656   03-12-89   640x480  256 colors 18 bits
  75. CM.GIF         47744   07-25-88   320x200  256 colors 18 bits
  76. SEV4.GIF      139264   06-18-89   640x480  256 colors 24 bits
  77. SHEPFIN.GIF   139264   02-13-89   640x480  256 colors 18 bits
  78. TDL.GIF         7035   09-08-88   320x200   16 colors  9 bits
  79.  
  80. ==================
  81. End sample output.
  82.  
  83. Usage: GIFLIST [/abdhpqrsvx] [path[mask]]
  84.  
  85. /a = ANSI mode, inserts color codes
  86. /b = Don't show color resolution
  87. /d = Don't display date of file
  88. /h = Show this help screen
  89. /p = Show bit planes instead of resolution
  90. /q = Quiet mode-no headers
  91. /r = RemoteAccess BBS file list (no size, no date)
  92. /s = Show size before name
  93. /v = Show version information
  94. /x = Phoenix BBS file list
  95.  
  96. path defaults to ".\*.gif"
  97.  
  98. "-" may be substituted for "/" as a switch character.
  99.  
  100. Usage examples:
  101.  
  102. giflist /qb
  103.  
  104.     (prints information for all *.gif files in current directory,
  105.     no headers, no color resolution information)
  106.  
  107. giflist /q /b
  108.  
  109.     (same as above)
  110.  
  111. giflist /p f:\tmp
  112.  
  113.     (prints information for all *.gif files in f:\tmp with bit
  114.     plane information)
  115.  
  116. giflist /s
  117.  
  118.     (prints information for all *.gif files with the size first
  119.     to facilitate sorting by size)
  120.  
  121.  
  122. A NOTE ABOUT COLOR RESOLUTION:
  123.  
  124.     It seems that not all GIFs have this information correct in
  125.     their descriptor...  Don't always believe it!
  126.  
  127. Please send comments and bug reports!
  128.  
  129. GENIE: D.BRUNETTE
  130. CIS: 76625,2243 (Dragon Technologies)
  131. USENET: oliveb!cdes!dragnet!dragon
  132. INTERNET: r2d2!dragon%island.uu.net
  133. BBS: Dragon's Lair, 415-876-0299, 2400/HST/V32 account: dragon keeper
  134. BBS: Network 23, 415-355-7162, 1200/2400/HST/V32 account: dragon keeper
  135.  
  136. Dragon Technologies
  137. 3641 Carter Drive
  138. So. San Francisco, CA 94080
  139.  
  140. VERSION HISTORY:
  141.  
  142. 1.0  17 APR 1989    Initial release.
  143. 1.1  04 JUL 1989    Slight speed up.
  144.             Added date display.
  145.             Added list date display.
  146.             Added option to print size first.
  147.             Fixed formatting when pixel rez > 1000
  148.             Can use upper/lower case switches
  149. 1.11  07 JUL 1989    Added Phoenix BBS file list compatibility
  150.             (inserts 0x04 character in listing, and
  151.             formats dates properly for "New" listing)
  152.             Suggested by Mark Williams, Network 23 BBS
  153. 1.12  30 JUL 1989    Ported to Turbo C 2.0 (1.12tc)
  154.             Increased buffer size to stop buffer clobber
  155.             Optimized size and speed
  156. 1.13  02 APR 1989    Added RemoteAccess (and QuickBBS?)
  157.             file listings.  Added ANSI color.
  158.  
  159.  
  160. BUGS:
  161.  
  162. Pathname parsing isn't too hot.  If you find a pathname that doesn't
  163. work (try it a few times, see bug below), please let me know the path
  164. you were trying to pass to GIFLIST.
  165.  
  166. The Turbo C version has real problems with the pathname parsing.  It is
  167. recommended that you only run this version of GIFLIST (tc) in the
  168. directory where the GIF files are.
  169.  
  170. Sometimes GIFLIST will not be able to open any files in a directory,
  171. the first time you run it in the directory.  This may be an MS-C bug
  172. but then again it may be my bug.  If you get a whole line of "Cannot
  173. open file!" errors just rerun the program.  If it doesn't go away,
  174. let me know, because it is a pathname parsing problem.
  175.  
  176. Doesn't differentiate between dates in the 20th and 21st century.  In
  177. fact, will display a wrong year number for dates beyond 2080.  Then
  178. again, WWIV software displays the wrong year for any date beyond 2000.
  179.  
  180.  
  181.